====== Extensions ======

Les extensions sont des ajouts à l'installation de Base de Mediawiki qui permettent d'en améliorer le fonctionnement, ajouter des tags ou des fonctionnalités.

Aucune de ces extensions n'est propre à Ubuntu

Les Extension décrites ci dessous on été testées sous Ubuntu 9.04 selon les requis de Mediawiki

<note important>Note importante:
Toutes les extensions demandent une modification de /var/www/mediawiki/LocalSettings.php : n'oubliez donc pas de faire un backup préalable à toute modification de ce fichier 
</note>



===== Pré requis =====
Avoir installé [[mediawiki]]


----

===== PDFexport =====

==== Définition ====
  * Date du test de l'extension: juillet 2009
  * Page officielle (en) [[http://http://www.mediawiki.org/wiki/Extension:Pdf_Export|pdfExport]]
  * PdfExport est une extension de MediaWiki particulièrement intéressante: elle permet de demander la traduction de l'article en format PDF. Dans le menu principal apparait alors dans le menu de gauche "Imprimer en PDF"

==== Pré-requis ====

Avoir installé [[apt://htmldoc]]

ou via un terminal :

 apt-get install htmldoc

==== installation ====

a) En mode superuser créer le répertoire 

/var/www/mediawiki/extensions/PdfExport

b) pour chacun des 4 fichiers ci dessous

  * récupérer le code 
  * créer le fichier ennoncé
  * le placer dans /var/www/mediawiki/extensions/PdfExport

   - [[http://www.mediawiki.org/wiki/Extension:Pdf_Export/Source_Code#PdfExport.php|PdfExport.php]]
   - [[http://www.mediawiki.org/wiki/Extension:Pdf_Export/Source_Code#PdfExport_body.php|PdfExport_body.php]]
   - [[http://www.mediawiki.org/wiki/Extension:Pdf_Export/Source_Code#PdfExport.i18n.php|PdfExport.i18n.php]]
   - [[http://www.mediawiki.org/wiki/Extension:Pdf_Export/Source_Code#PdfExport.i18n.alias.php|PdfExport.i18n.alias.php]]

c) dans le fichier /var/www/mediawiki/LocalSettings.php  et **avant la ligne** de demande de rafraichissement du cache

<php>
$wgCacheEpoch = max( $wgCacheEpoch, gmdate( 'YmdHis', @filemtime( __FILE__ ) ) );
</php>

**ajouter la ligne**

<php>
require_once("extensions/PdfExport/PdfExport.php");
</php>

d) Cette extension demande  une modification des droits d'accès de /var/www/mediawiki/im
ges/tmp pour que cette extension  puisse créer et effacer le fichier temporaire
==== utilisation ==== 
Dans le menu principal apparait alors dans le menu de gauche "Imprimer en PDF"

APERCU:

{{:pdfexport.jpg}}

==== Particularités rencontrées ==== 

  - "Imprimer en PDF" n'apparait que dans certains skin de MediaWiki
  -  lors des tests certaines erreurs d'affichage des quotes sont survenues dans l'export en PDF sans affecter le contenu du PDF

==== Rédaction par:  ==== 
[[:utilisateurs:phira]]
 
----


===== CITE (références /notes de bas de page) =====

==== Définition ====
  * Date du test de l'extension: aout  2009
  * Page officielle (en) [[http://www.mediawiki.org/wiki/Extension:Cite/Cite.php|Cite]]
  * CITE est une extension particulièrement utile pour les personnes qui souhaitent référencer ou citer leur sources par des notes de bas de page  . 

==== Pré-requis ====

aucun

==== installation ====

**Récupérer les fichiers** [[http://www.mediawiki.org/wiki/Special:ExtensionDistributor/Cite|situés ici]]
(j'ai pris la version "trunck")

**copier le répertoire** contenu dans l'archive dans le répertoire /var/www/mediawiki/extensions


**Ajouter la ligne**
dans le fichier /var/www/mediawiki/LocalSettings.php

<php>
require_once('extensions/Cite/Cite.php');
</php>

avant la ligne

<php>
$wgCacheEpoch = max( $wgCacheEpoch, gmdate( 'YmdHis', @filemtime( __FILE__ ) ) );
</php>

==== utilisation ====
placer vos références entre les tags <ref> et </ref>

à la fin de votre article placer simplement la balise
<references/>

Quand vous citez plusieurs fois la même source, il est particulièrement intéressant de les citer dans un même groupe entre les balises 
<ref name="nom_de_la_reference">et </ref>
chaque fois que vous souhaiterez faire appel à ce groupe il vous suffira de faire appel à la balise <ref name="nom_de_la_reference">


illustrations:
{{:tutoriel:tutoriel:pdfexport.jpg}}

==== Particularités rencontrées ==== 

aucune

==== Rédaction par:  ==== 
[[:utilisateurs:phira]]

----
<note warning>Page en cours de rédaction 

La liste exhaustive des extensions et de leur installation se trouve sur le site de MediaWiki </note>